Skip to main content

Get Bulk Transaction Filtered By Date

This API allows merchants to retrieve a list of their transactions within a specified date range. Results are paginated and include key financial breakdowns such as VAT, MDR, and processing fees.

Endpoint​

Method: GET
URL: baseUrl/api/v1/b2b/transactions/

Headers​

  • Authorization: Bearer {{accessToken}} (Include the token obtained from the Authentication API)
  • Content-Type: application/json

Example Request​

GET /api/v1/b2b/transactions/filter?startDate={YYYY-MM-DD}&endDate={YYYY-MM-DD}
Authorization: Bearer {{accessToken}}
Content-Type: application/json

Response​

A successful response returns a JSON object with the same structure as the Purchase API response:

{
  "content": [
    {
      "id": 1733,
      "amount": 500,
      "status": "APPROVED",
      "terminalId": "12343214",
      "date": "2025-09-02T13:04:39.037562",
      "rrn": "524510954762",
      "cardType": "Mada",
      "acquirerCode": "RYDB",
      "type": "PURCHASE",
      "vat": 6,
      "mdr": 45,
      "procFee": 0,
      "netAmount": 449,
      "uuid": "762bfb0c-1260-3591-a7ce-6ca121e073f8",
      "switch_response_code": "000",
      "provider_response_code": "00"
    }
  ],
  "totalPages": 1,
  "totalElements": 5,
  "currentPage": 0,
  "pageSize": 15
}

Usage Tips​

  1. Use startDate and endDate to limit results and retrieve transactions in that specific date range.
  2. Default pageSize is 15 transactions per page. Use pagination controls to retrieve more records.
  3. Recommended for B2B merchants to integrate directly into their internal reporting systems.